home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Original Shareware 1.1
/
The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso
/
7
/
zcomd289.zip
/
ZCOMMDOC.AF
< prev
next >
Wrap
Text File
|
1989-02-23
|
76KB
|
1,801 lines
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 151
u Enables Upper case conversion of keyboard and file characters sent
with the term function (t, f, F2 commands). The answerback and
programmed strings are not affected. Protocol file transfers are
not affected.
EXAMPLE: ena -u
SEE ALSO: ALT-U key
v View control characters as ^C. In addition to the above, vv mode
denotes characters with the parity bit set by prepending a tilde
(~). Finally, vvv mode prints incoming characters in hex.* The v
modes override the A, c, C, and Z modes.
EXAMPLE: t -iv bincapt.fil captures binary data from the modem to
bincapt.fil, with control characters displayed legibly.
NOTE: View mode is distinct from view option.
w Wait mode. When sending files with the term function, send the
contents of eolstr (CR by default) at the end of each line, and then
wait until echoes from the remote have stopped. Useful for sending
files to bulletin boards where the remote needs time to prepare for
the next text line. The p numeric parameter controls the length of
this wait, which is reset by each character received from the
remote.
EXAMPLE: f -w file
W Enable writing from the circular buffer to capture file (default
enabled).* The echof and echoc commands are not affected.
SEE ALSO: ki command
x,X EXit from the term function when EOF is encountered on transmitted
file. In addition, X mode causes the term function to exit when the
file upload is interrupted by reading a character matching the value
of the m numeric parameter. The x mode is the standard way for a
script to regain control after uploading a file with the term
function.
EXAMPLE: f -x upload.txt
SEE ALSO: m numeric parameter
y Yes it is OK to clobber a file already on disk when receiving to a
file. If absent, the operator is given a choice of appending to the
current file (a), erasing it (y) or aborting (n). This mode is
(C) 1988 Omen Tech Inc Chapter 19 Modes
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 152
reset at each command line and at each obey and function key,
pattern action, or downloaded command. This mode is not allowed if
ZCOMM is Restricted.
Z (Case is significant!) enables ZMODEM AutoDownload of commands and
files when the term function is active (this is the default). The
term function recognizes ZMODEM AutoDownload at 300 bps and higher
speeds.
EXAMPLE: dis -Z disables ZMODEM AutoDownload.
ZMODEM AutoDownload sends a security challenge to the sender to
discourage Trojan Horse messages. The challenge may be disabled
with an ena -yZ command, resulting in a time savings when using some
modems.
z Close file when CPMEOF (^Z) is encountered while writing the capture
buffer. z mode also appends a CTRL-Z (CP/M EOF) to the end of files
created with the apd, create, t file, browse/a, browse/A, review/w,
review/W, and > commands. Otherwise, ^Z is ignored.
NOTE: The Source coughs up an occasional ^Z just as the UPI program
is about to print an interesting article.
+ When receiving to a file already on disk, append the new data to the
old file. This mode is reset at each command line and at each obey
and function key, pattern action, or downloaded command. This mode
is not allowed if ZCOMM is Restricted.
(C) 1988 Omen Tech Inc Chapter 19 Term Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 153
20. TERM FUNCTION
Interactive conversation with the remote is controlled by the term
function. The term function provides the conversational link between
the keyboard, display, printer, and the remote computer. ZCOMM's term
function also controls the capture of data from the remote, "non-
protocol" sending of files and commands, and recognition of the
remote's responses (pattern searches).
The term function is entered by the F2, f, put, putw, t and wait
commands, and by the rx and sx commands when the t option is used.
Normally, the term function acts upon keyboarded characters
immediately. If the term function is sending a string with the put or
putw commands, or if the keyboard has been locked with the kbdlock
command, keystrokes are not drained from the keyboard buffer. If ANSI
KAM (Keyboard Action Mode) escape sequence has been received,
keystrokes are discarded with a bleep of the bell.
Normal ASCII printing and control characters are sent to the remote.
Some keys may be redefined with the set command. NUKE (ALT-N) returns
control to the main command prompt. The term function returns to its
caller when an F1 or ALT-X key is struck.
A carrier detect loss during a pattern search or a satisfied search[1]
cause the term function to return. Counting the error count (e
numeric parameter) UP TO 0 makes term function return. An ETX or EOT
received from the remote when q mode is on also does the trick.
Finally, an EOF on a file uploaded with x mode, or a match on a file
uploaded with X mode makes the term function return.
20.1 Command Characters
In the term function, soft key definitions override the keys' normal
functions.
ALT-= Toggles the term function keyboard handling between normal,
doorway, and scancode operation.
In doorway operation, ALT, cursor, and function keys are transmitted
as NULL followed by the raw scan code. In scancode mode, the raw
scan codes are transmitted for use by VP/ix and other programs that
require raw IBM keyboard scan codes.
Both doorway or scancode operation override all term function key
__________
1. Unless the c modifier was used
(C) 1988 Omen Tech Inc Chapter 20 Term Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 154
bindings escept for ALT-= which toggles between these three forms of
operation.
Backspace Normally the term function sends backspace to the remote
without any special processing. This is ideal for most systems
where backspace implies deletion of the character immediately to the
left of the cursor. Other systems, including VMS, use RUBOUT for
this function. The GCOS system uses the # character for this
function. The special requirements of these systems can be
optimally accomodated by assigning a string or series of commands to
the BS key. Chapter 99 provides some examples.
F1, ALT-X Return from the term function. ALT-X is an alternate to F1
in case the user has assigned his own string or command to F1.
F2, PgUp, PgDn, ALT-R Enter the review function displaying data
starting with either the first character received after the last
character keyboarded (except space, Ctrl-Q, or Ctrl-S), or about 48
lines back if less than 400 characters have been received since the
last character keyboarded. This allows the output from the last
command to be conveniently reviewed. Review then awaits the next
command.
F2 followed by "k" is a handy way to clear both the screen and the
circular buffer.
Up Enter remote command recall and select the previous remote command
for editing in the status line. Backspace, and Ctrl-W may be used
for editing the line. Ctrl-U and Ctrl-X clear the line's contents
and restore normal term function operation.
Down Enter remote command recall and select the next remote command
for editing in the status line.
Home Enter review function, displaying text starting at the beginning
of the buffer. ALT-R is an alternate to F2 in case the user has
assigned his own string or command to F2.
F3...F10, FS1...FS4 Chapter 15 describes the functions that the
"setup" entry in the sample PHODIR.t file assigns to these keys.
Ctrl-Break Sends a 200 millisecond (default) break signal to the
remote. The function of this key may be reassigned with a set
command.
NOTE: Some modems do not correctly pass the break signal to the
remote.
Ctrl-Shift-2 Some remote computer systems may require sending the NULL
(000) character. NULL may be keyboarded by Ctrl-Shift-2.
(C) 1988 Omen Tech Inc Chapter 20 Term Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 155
^F Iff q (TWX) mode is in effect, transmit the string parameter
answerback to the remote. This is equivalent to HEREIS on a
Teletype(TM) machine.
Enter Iff n mode is set, send a newline (LF). Otherwise, send the
contents of entstr (default CR) to the remote.
^Q Iff a transmit file is open and its transmission has been stopped
by a XOFF, transmission is resumed. Resumes counting of the
inactivity timeout associated with the wait and pattern commands.
Otherwise no special treatment.
Rubout The ASCII delete (rubout) character (hex 7F, octal 177) is
generated by Ctrl-Backspace (the left arrow above the ENTER key on
the PC keyboard). The "Del" key near the lower right of the
keyboard does not generate delete, but may be programmed to do so
with a "set fdel \177" command.
^S Iff a transmit file is open, transmission is stopped. Otherwise ^S
is transmitted. ^S also suspends counting of the inactivity timeout
associated with the wait and pattern commands.
ALT-B Sends a 100 millisecond break signal to the remote.
NOTE: Some modems do not correctly pass the break signal to the
remote.
ALT-N The NUKE key exits from the term function with a message and
cancels any scripts or functions that may have been executing.
ALT-1 Prompts for a DOS command, then executes that command as a
subroutine.
EXAMPLE: ALT-1 whereis *.lst
ALT-2 Prompts for a ZCOMM command, then executes that command. A
particularly useful command is "create file" which creates a capture
file without having to return to the main command prompt. Care
should be exercised not to force excessive recursion by issuing a
command (such as t or f) which would invoke the term function
recursively.
EXAMPLE: ALT-2 create capture.fil
EXAMPLE: ALT-2 display vt100
ALT-E Resets the elapsed time indication to zero.
(C) 1988 Omen Tech Inc Chapter 20 Term Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 156
ALT-F Full Duplex resets local echo of keyboarded characters.
ALT-H Toggles Half duplex in the sequence 0 (full duplex), 1 (local
echo), and 2 (local echo CR as CR LF). SEE ALSO: h numeric
parameter
ALT-I Three way toggle of i and I (Image) mode. When toggling to I
(super image) mode, ZCOMM's display emulation is set to dumb to
disable all escape sequences, most importantly those that do strange
things when used in the wrong context. When toggling out of I mode,
dumb terminal emulation is turned off.
ALT-J Toggles j (Jabberwrite) mode (q.v.).*
ALT-K Displays the contents of the soft keys.
ALT-L Ctrl-PrtSc Toggles the line printer on flag. If the printer is
being turned on, printing commences with the next character received
from the remote.
ALT-M Toggles keyboard mapping.
SEE ALSO: display mapkb command
ALT-O Toggles the Overstrike display mode, and restores the normal CRT
attribute.
ALT-P Toggles the parity the term function uses between 8 bits no
parity, 8 bits graphics, 7 bits plus even parity, 7 bits plus odd
parity, 7 bits marking parity (8th bit set), and 7 bits spacing
parity (8 bit reset).
ALT-V Four way toggles v mode between normal, show control characters
as ^C, denote characters with parity bit (in addition to the above)
set by prepending a tilde (~), and display all characters in hex.*
20.2 Control Characters
The following characters are recognized by the term function when they
are received from the remote.
ENQ, DLE If c or C (Compuserve) mode and not v mode is in effect,
engage the Compuserve B Protocol. This protocol is used with the
FILTRN program and the SIG/ACCESS DOW and UPL commands. See
Compuserve's CP-MIG user group documentation for more information.
Iff enabled, these codes are acted upon when drained from the
interrupt input buffer and are not passed to the circular buffer.
The following received characters are recognized by the term function,
regardless of parity, when they are fetched from the circular buffer
for the display.
(C) 1988 Omen Tech Inc Chapter 20 Term Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 157
Modem Error Detected modem errors (parity error, framing error, break,
overrun) are counted in the e numeric parameter. The E numeric
parameter may be used to represent modem errors as specific,
searchable characters.
A detected overrun is displayed as a large fuzzy rectangle (hex B2).
ETX EOT Ctrl-Z When receiving a message with the TWX protocol (in Host
Operation) these control characters will terminate the message.
ENQ Iff q (TWX) mode or VT100 emulation ("display vt") is in effect,
transmit the answerback string parameter to the remote. This is
equivalent to HEREIS on a Teletype(TM) machine.
BELL Generates a tone in the speaker unless visual bell display is
enabled ("display bell=visual"). If the display has fallen behind
the incoming data, ZCOMM suppresses the bell due to the relatively
long time required to perform a bell ring. If a file is being
transmitted with the term function, a bell character will pause
transmission for a short time. (Some computers send bell characters
to indicate their input buffers are becoming overloaded.)
FF If c mode is enabled, erase the screen.
XOFF Suspends file transmission from ZCOMM. XOFF is excluded from
pattern searches and does not display unless v mode is set. After a
timeout determined by the Kermit s numeric parameter (default 60
seconds), transmission will resume even if no XON character is
received.[2]
XON Resumes file transmission from ZCOMM. XON is excluded from
pattern searches and does not display unless v mode is set.
NULL, Rubout (Hex 7F) and NULL (0) are not displayed unless ZCOMM is
in i (image) or v mode. They are excluded from pattern searches.
20.3 Buffer Writing
If e (Emacs) mode is set, a buffer dump is performed before each
keyboarded character is sent to the remote, since normal XOFF based
flow control is assumed to be disabled.
When the free space in the circular buffer is nearly exhausted, ZCOMM
sends an XOFF character to the remote[3] and writes the buffer
__________
2. There is no timeout if the parameter is 0.
3. Assuming e mode is not in effect.
(C) 1988 Omen Tech Inc Chapter 20 Term Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 158
contents to the receive file[4] (if any). The circular buffer is also
written to the receive file as a result of a "w" command, ALT-W key,
or once per second if j mode is in effect.
When the circular buffer is written to a receive file, several control
characters are treated specially if i (image) mode is not set. Iff s
mode is set, all control characters, except for those listed below,
are excluded from the received file.
NULL ACK BELL XON XOFF RUBOUT ESC These characters are excluded from
the file. Most "escape sequences" are also filtered form the
cpature file. NULL, DELETE, XON, and XOFF are excluded from pattern
searches.
ETX, EOT These characters close the file if q mode is in effect, as
when ZCOMM is receiving a message in host state using TWX protocol.
Ctrl-Z (CPMEOF) Iff z mode is enabled, close the file. Otherwise this
character is discarded.
LF Iff n (nlmode) mode is on, a CR is written to the file before the
LF. Linefeed is always passed to the file.
CR Iff a mode is in effect, a CR LF sequence is written to the file.
Otherwise, if s mode is on, CR is only written to the file as a
response to an LF in the circular buffer.
BS Backspace is written to the file unless s mode is in effect, in
which case it, and the last character written in the disk file, are
deleted by backspacing the file write pointer. This simulates the
function of backspace on common CRT terminals.
NOTE: This backspacing of the file write pointer operates the same
as Teco and Emacs editors; it does not stop at the beginning of the
line. Backspacing over tab characters is tricky because it may take
several backspaces to eliminate the spaces corresponding to one tab
character, but only one is needed to eliminate the tab character in
the output file.
HT FF These characters are always passed to the file, even if s mode
is in effect. If ss mode is in effect, FF is not passed to the
file.
__________
4. An XON is sent to the remote after this automatic buffer write
operation.
(C) 1988 Omen Tech Inc Chapter 20 Term Function Status Line
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 159
20.4 Real Time Status Line
A real time status line is displayed when ZCOMM is in the term
function. The left part of this status line is also displayed when
ZCOMM is in Host Operation awaiting a call.
The first character position shows a blinking W if the circular buffer
is being written to disk. Otherwise, the first character position
shows an L if the keyboard has been locked by a kbdlock command, or C
if the Caps Lock key is activated.
The second position shows an X if hardware handshaking is enabled and
Clear to Send (CTS) is not received from the modem, or if an XOFF
character has been received (software handshake). This also happens
when a file upload is using the p mode with GOchar = 17 (17 is decimal
for XON) and ZCOMM has stopped at the end of a line. Otherwise, an M
is shown to indicate Keypad Mapped operation for terminal emulation.
Otherwise, an N appears if the Num Lock key is activated.
SEE ALSO: handshake command, Terminal Emulation, Chapter 24.
The third position displays the real time status of the following five
conditions. If more than one of the conditions is active at once, the
displayed character will represent the condition listed first.
X if the buffer has nearly filled up and ZCOMM has sent an XOFF to
suspend data transmission from the remote.
E when ZCOMM has sent an XOFF to suspend data transmission for Error
Containment(TM).
S if the term function is searching for one or more strings (defined
by the pattern command).
W if term is waiting for a character echo before resuming
transmission.
w if term is waiting for a fixed time before sending the next
character or returning from a putw or wait command.
The display column and row numbers are displayed next with the home
position equivalent to 1, 1. DOS's idea of the time of day is next.
The minutes of elapsed time follow the time of day, modulo 24 hours
(1440 minutes). The elapsed time is reset by the ALT-E term
subcommand and by the autodial.
If carrier detect is absent, an L( Local) appears after the elapsed
time. The X.PC version will display c, p, or L in this position
depending on whether ZCOMM is in character state, packet state, or
Local (no carrier detect).
The right side of the status line shows the communications port,[5]
(C) 1988 Omen Tech Inc Chapter 20 Term Function Status Line
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 160
transmission speed ("baud rate") and the parity.
The next field represents the modes that are enabled. If the b, n, p,
r, or w mode is set, that letter shows. If p mode is set with with
GOchar equal to XON (decimal 17), a P is shown.
The v mode causes the view indicator to show ^ if control characters
are being displayed in the style ^C where C is the alphabetic
character corresponding to the control character. The indicator shows
~ if characters with the 8th bit set are being displayed with a
leading ~.
Setting the a, c, e, h, i, j, l, q, s, t, u, x, and z modes causes the
corresponding letter to be displayed. The c, h, and s modes are
displayed in upper case if their value is greater than 1.
ON HOOK is displayed if the computer has disabled DTR (Data Terminal
Ready). The speed command should be used to assert DTR and allow the
modem to go off hook (connect to line), e.g., "speed 1200".
If a transmit file is open, a < followed by the transmit file name is
shown.
If the file upload has been stopped by a grab command, Stopped(grab)
is diplayed.
If a receive capture file is open, a > followed by the file name is
shown.
EXAMPLE: LX 01 24 23:57 ET 0:46 L 31424 1:1200 8n p^t <upload.fil
The keyboard has been "locked" by a kbdlock 1 command. File upload
has been stopped by an XOFF character. The cursor in in column 1,
line 24. The elapsed time is 46 seconds. Carrier is not present (L).
There are 31424 free bytes in the circular buffer. Transmission speed
is 1200 bits per second. Transmitted word length is 8 bits no parity
(8n). Since a speed of 1200 selects 1 stop bit, the mode is the same
as "8-N-1" mentioned by many bulletin board systems. The p mode makes
file upload pause at the end of each line for a prompt character.
View mode is set (ena -v). Finally, t mode slows the transmission of
each character from a soft keys or file. The disk file upload.fil is
being uploaded.
The s numeric parameter sets the status line display attribute. The
default of 7 provides normal video. With some displays, you can set
______________________________________________________________________
5. Virtual channel number for X.PC
(C) 1988 Omen Tech Inc Chapter 20 Term Function Status Line
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 161
it to dim with a ps8 command so it won't distract you. It may be
disabled with an "ESC x 1" sequence.
20.5 Conference Command/Local Editing
When the conference command is given, two cursors appear. The usual
cursor will follow text as it arrives from the remote computer. A
second cursor in the conference window follows the text that you
enter.
While entering text to the conference window, the editing keys may be
used to correct keyboarding mistakes.
Beginning at column 64, the characters you enter will show in reverse
video to remind you that the line is getting long. (Conferencing
software prepends your identifier or "handle" to each line you send; a
long line will drop characters or otherwise mess up others' displays.)
When you keyboard ENTER, LF, or ESC, or when you fill up the
conference window, ZCOMM queues the line for transmission. The
conference window cursor disappears while the line is queued for
transmission.
The line is transmitted as soon as the previous line (if any) has been
sent. When transmission begins, the conference window is cleared and
the conference cursor reappears, allowing the next line to be
keyboarded. Attempts to enter characters into the conference window
before transmission begins will ring the bell and be discarded.
When in the conference command, the function keys operate the same way
as they normally do in the term function. The review subcommands (F2,
PgUp, etc.) may be used to review portions of the conversation that
have scrolled off the main screen. The exit command F1 causes any
characters entered in the conference window to be discarded.
The following characters are passed directly to the remote and are not
entered into the conference window: ETX SI DLE XON XOFF DC2 DC4 (^C ^O
^P ^Q ^S ^R ^T).
Transmission from the conference window is controlled by the t, p, and
w modes and their associated parameters. If none of these modes are
set, the line is transmitted at full speed. If Half Duplex mode h is
set, ZCOMM echoes the line as it is transmitted. If H is set, a
linefeed is transmitted and displayed after the carriage return.
(C) 1988 Omen Tech Inc Chapter 20 Review Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 162
21. REVIEW FUNCTION
Review function commands page, search, cut, paste, and otherwise
manipulate captured data stored in the circular buffer.
The review function displays the approximate location of the displayed
text within the circular buffer as a percentage of the buffer contents
on the status line. Unless i mode is in effect, escape characters are
printed as $ (dollar sign) so they will not interfere with scrolling.
Review subcommands consist of a single character preceded by an
optional numeric argument. (The default value is 1.) The numeric
digits and the command are not echoed as they are entered. For
example, keyboarding 69+ moves down 69 lines.
You don't have to wait for the screen to fill before entering the next
review subcommand. This comes in handy with the n subcommand. Since
the N subcommand searches in the reverse direction, you can thumb
through messages (by searching for the subject header) very quickly,
knowing that you can back up if you went past something interesting.
21.1 Review Subcommands
Defined soft keys are executed from review iff they do not conflict
with the permanent definitions.
Ctrl-L, Ctrl-Home Ctrl-L (form feed) clears the screen and refreshes
the display without moving it. Ctrl-L is useful after an error
printout within review, or after a subcommand that writes to the
screen such as ALT-D or ALT-S.
a Toggles the autowarp display mode, then refreshes the display.
If the autowrap display mode is enabled, long lines can be
viewed, but will cause lines at the top of the screen to scroll
off.
G Go to the Nth line and display from there. If N is omitted, go
to the end instead.
Home Display starting at the beginning of the capture buffer.
r, R If a file is open as a result of a read command, read some more
of the file into the buffer, replacing about 3/4 of the previous
buffer contents (all if R subcommand). A successful r subcommand
erases the pointers set by the t and b subcommands. The data
read in from the file may overwrite the data currently displayed
on the screen. In this case, ZCOMM displays data starting with
the oldest.
(C) 1988 Omen Tech Inc Chapter 21 Review Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 163
F2, PgUp, ^B, * Display the Nth previous page (one line overlap is
provided).
SP, PgDn, ^F Clear screen and display the next Nth page.
s, / Accept a search string, terminated by RETURN. This string may
have character escapes. Search through the buffer for the Nth
instance of string. Lower case characters in string match either
case; upper case characters in string match upper case characters
only. The display starts with that line. If the search is
unsuccessful, ring bell. The search begins at the top of the
display.
SEE ALSO: ?, n, N subcommands
? Prompts for search string as above, then searches backwards for
the Nth occurrence of string starting with the line above the top
of the buffer.
n Next searches for Nth occurrence of the previously entered string
in the direction of the last "/" or "?" subcommand. Typical
usage would be to search for the first occurrence with the "/"
subcommand, then use "n" to find more matches.
N Next searches for next Nth occurrence of the previously entered
search string in the opposite direction to the original "/" or
"?" subcommand.
UpCursor, - Backup N lines and redisplay.
DownCursor, +, LF Move the display down N lines and redisplay.
End Go to the buffer end (where the most recent data is) and display.
x eXit returns to the previous function, and makes the term
function redisplay the last page of buffer contents.[1] This
restores the screen and keyboard to the same state they were in
before review was entered. The x subcommand allows you to see
where you were if you were in the midst of keyboarding a command
to the remote when you entered review.
EXAMPLE: Suppose you are typing in a line of commands and you
need to "thumb back" through the remote's output for some vital
nugget of information. (After you enter a 20 line email reply
__________
1. When the term function takes control, which is immediately if
review was called from the term function.
(C) 1988 Omen Tech Inc Chapter 21 Review Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 164
message, NOW Compuserve asks you for a certain random 8 digit
account number to mail it to!) No sweat, just hit some PgUp's
until you see the account number on the screen. Now you can't
remember whether or not you typed a space after the last part of
you command to the remote. No problem, just exit review with x
and you'll see just where you were.
NOTE: This subcommand should not be used when scripts are active.
k Kill the capture buffer contents and return to the previous
function.
Ctrl-Z, Ctrl-PgDn Kill the rest of the buffer by setting the character
insertion pointer to just after the end of the current display.
ZCOMM then redisplays the last lines of the buffer and returns to
the previous function.
t Set the file dump[2] and printer dump pointers to the top of
displayed text, and sets the bottom pointer to the end of the
buffer. The t subcommand is used with the b subcommand to
specify which portion of the circular buffer should be written to
a file with the w subcommand. (Text between the top and bottom
pointers is highlighted.)
b Set the bottom pointer to the beginning of the first line of
displayed text. If the top pointer had not been previously set,
or if the bottom pointer is before the top pointer, ZCOMM will
ring the bell and ignore the subcommand. Otherwise, the text on
the screen that was highlighted will now be displayed in normal
intensity as what is showing on the screen has just been
deselected. (Text between the top and bottom pointers is
highlighted.)
w, W Write the text between the top and bottom pointers to a disk file
or DOS device.[3] If the bottom pointer is not set, the rest of
the buffer will be written. ZCOMM prompts for a pathname. If
the top pointer is not set, a reminder is printed. No log entry
is made by this subcommand. The W subcommand automatically
appends the data to an existing file.
F1, CR Return to previous function.
__________
2. This command should not be used while outputting to the printer (l
mode) or while a Receive File is open unless you wish to select
the data to be output.
3. Useful DOS devices are PRN, LPT1, LPT2, and LPT3.
(C) 1988 Omen Tech Inc Chapter 21 Review Function
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 165
! Prompts for a DOS command, then attempts to execute it (DOS
Gateway).
@ Prompts for a ZCOMM command, then executes it.
(C) 1988 Omen Tech Inc Chapter 21 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 166
22. NUMERIC PARAMETERS
Numeric parameters are set with the p command in the form px# where x
is the one letter name of the parameter and "#" is the numeric value.
Numbers may have an optional leading "-" (minus) sign. Numbers are
normally decimal, but hex numbers may be input as 0xHH, printing ASCII
character values may be entered as 0cC, and control characters may be
represented as 0^C.
Value Possible entries
65 65 0x41 0cA
3 3 0x3 0^C
Typing "p" without a parameter name displays the current values of the
numeric parameters in decimal.
EXAMPLE: pS5 sets the timeout interval in seconds waiting for XON
characters or positive flow control. to decimal 5 seconds.
EXAMPLE: pv-1 sets the v numeric parameter to -1, suppressing some
routine messages
# The # numeric parameter sets the number of lines used by the built
in display driver. The default value is 24. A value of 25 may be
used for applications which require access to all 25 display lines.
A small value may be used when running ZCOMM under TopView to to
fit the information into a small window. The cls or reset command
should be given after setting the parameters to initialize the
screen driver to the new values. If running with a virtual screen
with TopView or DESQview, the #and $ numeric parameters are limited
to 24 by 80 maximum. Full screen applications may give abnormal
displays if these parameters are set too small. Nonsensical values
tend to produce nonsensical displays.
EXAMPLE: cls; p#9; reset clears the screen, sets a 9 line window,
and initializes the screen driver to the new value.
$ Sets the number of CRT columns. A cls or reset command should be
given after changing the $ numeric parameter. The default value
(80) is that returned by the BIOS video interrupt 15h call. This
parameter may be set to support 132 column displays if the 132
column display mode is set before ZCOMM is called.[1] ZCOMM does
__________
1. With most display BIOS ROMs, ZCOMM reads the columns and lines
values from the BIOS when starting up or regaining control after a
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 167
not support displays less than 80 columns wide. The display
hardware must use the same number of columns as the $ parameter if
the resultant presentation is to make any sense.
SEE ALSO: # and V numeric parameters
- If non zero, the DOS Gateway (used with the ! command, etc.) uses
the undocumented DOS 37h function to fetch the current value of
SWITCHAR.
If negative, ZCOMM uses DOS line input (function 0xA) for commands
given from the main prompt. This enables DOS command line editors
such as POLYboost [2] and CED. When these editors are active, they
(and not ZCOMM) interpret control, function and ALT- keys.
* Sets the CRT attribute for highlighted messages.
EXAMPLE: p*12 gives bright red.
? Count of the number of files sent or received with a protocol, and
the number of lines matched by the find command. A failed password
validation sets this negative. The exit status of subprograms is
stored in this parameter. Because of a bug in DOS COMMAND.COM, the
return value is valid only with Unix/Xenix flavors.
SEE ALSO: ? test condition
@ Sets the CRT attribute for the (normally) blinking messages such as
FILES OPEN. The numeric values are explained below, with the n
numeric parameter.
EXAMPLE: p@12 makes ZCOMM's normally blinking messages appear
bright red.
If set non zero (the default), causes a drop of DTR, equivalent to a
bye command each time a telephone number is dialed as a command.
B If set non zero (the default), causes a bye command to be issued
each time a telephone number is executed as a command.
SEE ALSO: mcommand string parameter, number dialing commands
______________________________________________________________________
DOS Gateway.
2. POLYboost is a product of the POLYTRON corporation.
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 168
E If non 0, substitute this for characters with bad parity detected
by the term function with e mode (Error Containment(TM)).
EXAMPLE: ena -7e; pE63 Substitute ? for characters received with
odd parity.
F Sets the CRT attribute for dim (faint) messages such as ANSI SGR2.
EXAMPLE: pF8 gives gray.
H Sets the timeout in seconds for entering a command or string in
response to a command or other prompt, including the accept
command. A value of 0 (the default) disables this timeout.
K If non 0, executes keyboard BIOS calls to recover extended codes
from 101 key keyboards.
N When enabled with display mapkb, this parameter controls the
relationship between ANSI/VT52 Alternate Keypad mode (DECKPAM,
ESC=), ANSI Numeric Keypad mode (DECKPNM, ESC>), and the PC's
keyboard Num-Lock state.
0 causes ZCOMM to set the PC's keyboard Num_Lock state to match
Numeric Keypad mode when DECKPNM or DECKPAM is received.
32 causes ZCOMM to set the PC's keyboard Num_Lock state to the
opposite of Numeric Keypad mode when DECKPNM or DECKPAM is
received.
1 causes ZCOMM to set the PC's keyboard Num_Lock off in response
to either DECKPNM or DECKPAM.
2 causes ZCOMM to set the PC's keyboard Num_Lock on in response to
either DECKPNM or DECKPAM.
SEE ALSO: display, mk and ALT-M commands
O Controls OverThruster(TM) operation with XMODEM, XMODEM-1k, YMODEM,
and YMODEM-1k downloads. This parameter should be set as follows:
CompuServe XMODEM This OverThruster mode is known to be effective
on CompuServe. Negative numbers control the number of bytes
added to the window on XMODEM downloads from the network.
Larger numbers increase throughput, but cause improperly
interfaced MNP modems nodes to drop characters under stress,
disrupting the file transfer.
EXAMPLE: pO-512; ro file1.ext
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 169
Other XMODEM Positive numbers up to a system dependent value less
than the protocol block size increase throughput. Larger
values induce timeouts and/or retransmitted blocks. The
optimum value must be determined by experiment. If you see
the message: Retry 0: Received dup Sector very often, the
value should be reduced. 60 usually give best results with
MNP modems at 2400 bps. The optimum value varies depending on
the remote computer, modem(s), system traffic, and the network
node.
EXAMPLE: pO60; ro file1.ext
R If non zero, remove incomplete files received with a protocol
except those received with the + option (default 0).
S Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
T If Command Retry has been enabled with the history command, the T
parameter prevents commands with fewer than T characters from being
stored in the history file. Excluding short and easy to type
commands from the history file makes it easier to find the commands
that are difficult to keyboard.
Setting T to a large number disables the storage of commands and
strings. This may be used to exclude passwords and other sensitive
information from the history file.
SEE ALSO: history command
V VIDEO BIOS display mode to switch the display to 132 columns in
response to a VT-100 DECCOLM mode set command. To support boards
using an extended code in the bl register, calculate N = bl + (256
* al).
A popular value is 35 for the Tseng, ATI, and other extended EGA
boards. The Genoa Super EGA Hi-Res likes 96. The Everex EVGA uses
28684. The default value of 0 inhibits this function.
X On Unix flavors, preset to +1 if the XTERM environment variable
contains xterm, preset to -1 if the variable contains the string
401 indicating a Tektronix storage tube graphics terminal,
otherwise remains at 0. Positive values allow the term function to
use the X Windows xterm status line. Negative values inhibit
status line updates while Tek graphics are active.
Z Hot zone column used for keyboard entry with the message and
privatecommands. A space character keyboarded within the hot zone
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 170
finishes the line.
a The a parameter calibrates certain protocol timeouts. The default
value is set during initialization to an appropriate value for an
IBM Personal Computer, PC-jr, DG/One, or 8mHz PC-AT (2000 for 4.77
mHz PC, 4000 for a PS2/30, 6000 for an 8 mHz AT, 12000 for a
PS2/80). If ZCOMM is run on a non standard machine, accelerator,
or under a time slicing operating environment such as TopView,
these timeouts may be recalibrated with the a numeric parameter.
Larger numbers give longer timeouts. This parameter should then be
set with a pa# command in the telephone directory setup entry. The
value for this parameter will change if ZCOMM is used with a
different computer type or multitasking operating system.
b Sets the video color for the screen border. The mapping of b
parameter values to color is hardware dependent. New values of the
b parameter take effect with the next screen clear.
c The c parameter sets the callout interval in seconds between scans
for outgoing messages. The default is 300 seconds (five minutes).
EXAMPLE: pc600 sets the interval between callout queue scans to 10
minutes.
SEE ALSO: Callout queue
d A non zero value (the default) causes incoming files received with
ZMODEM and full YMODEM Batch protocol to have their Date set to
that sent in the file header. ZMODEM's file management features
depend on the transmission of each file's modification date. Files
between two copies of ZCOMM will have the same creation date, even
if the two machines are in different time zones. When transferring
files to/from a Unix system, creation dates are interpreted
according to GMT or Universal Coordinated Time. File dating should
be enabled with a pd1 command in the telephone directory setup
entry.
SEE ALSO: z numeric parameter, ZONE environment variable
NOTE: Backdating file creation times may confuse some backup
programs.
e Indicates the number of errors, failed file transfers and the
number of characters received by the term function with parity
error, framing error or overrun.
EXAMPLE: if e>30 goto badline
If the term function increments the error count to 0[3] (from a
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 171
negative number), and E mode is set, the term function exits. This
allows the script to regain control in the event of a noisy line.
This condition is indicated by the e test condition being false
(0).
EXAMPLE: pe-20; ... wait; if !e goto badline
This parameter is reset to 0 by the call command.
SEE ALSO: e numeric parameter, E mode
SEE ALSO: e test condition (if, while commands)
f Fail time. Sets the default timeout in seconds for matching a
pattern. This timeout is reset whenever a character is received
from the remote. Timeout is suspended whenever a XOFF (DC3 or
Control-S) is keyboarded, and resumed when XON (DC1 or Control-Q)
is keyboarded. This value may be overridden for one command by the
ftime mode.
EXAMPLE: pf15 sets a default 15 second inactivity timeout for
pattern searches.
g Set the "gochar" (decimal). (See the ASCII/Decimal conversion
table in Chapter 29). The g parameter is reset to its default
(linefeed, 10) by the call command. (See documentation on the p
mode.)
Some remote systems accept uploads with a ? (decimal 63) prompt for
each line. Optimum operation with such a system might call for
pg63 pp1000 pt4 f -tp file1
The pg63 sets the goahead character to question mark. The pp1000
sets the timeout to a long delay (10 seconds). Te pt4 sets the
upload throttle to 40 milliseconds per characters, a speed which
allows the remote to echo somewhat slowly (assuming no tabs).
Finally, the command f -tp file sends file1 with Throttle and wait
for Prompt at end of line.
As a special case, if the "gochar" is set to 17 (called XON, DC1,
or ^Q) before the p mode is set, file transmission is stopped until
an XON is keyboarded or received from the remote.
______________________________________________________________________
3. Refer to E mode description for caveats.
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 172
EXAMPLE: pg17; ena -p
h Iff the h numeric parameter is set non zero, the h (Half Duplex)
mode causes characters transmitted by the term function to be
stored in the circular buffer as if they had been received from the
remote. This allows the review function to display them. Since
the echoed characters appear to have come from the remote, scripts
may be affected, especially pattern searches.
EXAMPLE: ph1; ena -h
i Set the interval between retries to n seconds.
EXAMPLE: pi4; call -200 busysys attack dials with 4 second
intervals up to 201 times.
SEE ALSO: call -n command
j Sets the maximum connect time in seconds allowed restricted callers
in host operation. The default value of 0 does not restrict
connect time.
EXAMPLE: pj300 disconnects restricted callers at the first command
prompt after 5 minutes' connect time.
k When receiving data from the remote at high speeds (9600 or
faster), the display may fall behind data from the remote. Under
these conditions, keyboarding an interrupt character (often Ctrl-C,
or Break) will immediately stop the output from the remote, but the
display will continue to scroll for some time while the data in the
circular buffer is displayed. If this is objectionable, the k
parameter may be set to the remote's particular interrupt character
(in decimal). This parameter also affects the link command. When
this character is keyboarded, undisplayed data pending in the
circular buffer is skipped over. (This data is still available to
the review command. The call command resets this parameter to -1,
disabling its function.
EXAMPLE: Many DEC systems use ETX (Ctrl-C) to interrupt programs.
Many Unix users also use ETX for interrupting programs. The
command pk3 causes ZCOMM to skip buffered output from the remote.
Unix users using the default interrupt character of RUBOUT may give
the command pk127
l Selects LPTn for term function output when the l mode is set. In
addition, adding 8 to the number allows terminal emulation escape
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 173
codes to select "printer controller mode" iff the printer is ready
at the time. Adding 16 to the number allows "printer controller
mode" to be selected even if the printer is not ready at the time.
Default is 1 (LPT1).
EXAMPLE: pl2 selects LPT2.
EXAMPLE: pl9 selects LPT1 and allows the remote application to
enable "printer controller mode".
m Causes file transmission with the f file command to pause when a
character matching the decimal value is read from the file. That
character is NOT transmitted. When the file uploading is paused, a
keyboarded Ctrl-Q will resume transmission. The call command
resets the m parameter to -1 (which matches nothing).
EXAMPLE: pm12 Causes file uploading to pause on FormFeed (FF).
n Set the normal display attribute. The default of 7 gives a normal
white on black display. The numbers associated with the s, r, and
n are stored in the attribute byte of each character position
written in the corresponding mode.
The bit configuration (color display) is: Blink R G B Intensity R
G B with the leftmost the most significant.
Users with color monitors often use 2 (green) to avoid color
fringes caused by misconverged color monitors.
NOTE: the actual writing color attribute is not changed until the
next time the display is reset. Some attributes generate
unreadable displays. Other attributes generate text that can only
be seen on some monitors.
EXAMPLE: pn3 sets cyan; pn2 sets green.
o Iff non zero, allows overlap of file writing and incoming data from
the remote. This increases throughput when receiving files with B,
Extended Quick B, XMODEM, and YMODEM Batch protocols. ZCOMM sets
this to 1 on startup unless a PC-jr is detected.
p Pause sets the echo wait period (in hundredths of seconds) used
with the pattern command and the w and p modes. Larger numbers
give longer pauses. The default works well with most micro based
bulletin board systems. The p parameter is reset to its default of
70 (700 milliseconds approximately) by the call command.
SEE ALSO: p mode
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 174
q Sets the "gopause". When sending a file with a wait for "gochar" (
p mode), ZCOMM waits Gopause hundredths of seconds AFTER it
receives the "gochar". The q parameter also controls the time
delay after a normal pattern match or putw command.
The q parameter is reset to its default of 70 (700 milliseconds
approximately) by the call command. The default value allows time
for immediate echoes to be displayed and for the Hayes
SmartModem(TM) to respond to most commands.
SEE ALSO: p mode
r Set the attribute for "reverse video".
EXAMPLE: pr97 sets "reverse video" to blue on yellow.
SEE ALSO: n numeric parameter
s Set the attribute of the status line display (default 7, for
white). A value of 8 (grey) may be chosen to prevent the status
line display from distracting from the information being printed.
The low intensity grey also minimizes phosphor burn. Some other
possibilities are 2 for green, and 1 for blue (or underlined on the
monochrome board).
SEE ALSO: n numeric parameter
t Sets the throttle speed (delay between characters in hundredths of
seconds) used by the term function when uploading files with an f
-t file command. The default value of 4 corresponds to about 20
characters per second sending speed when t mode is enabled. Larger
numbers give slower transmission. The effective resolution of the
t parameter is limited by the timekeeping resolution of the
operating system; on PC-DOS the resolution is about 18 per second.
A negative value (-1 to -32767) may be used to specify a software
timing loop, with more negative values giving slower transmission.
The speed effect of a negative t value depends on the processor
speed and operating environment.
The t parameter is reset to its default by the call command.
SEE ALSO: t mode
u Sets the video attribute used to represent underline.
EXAMPLE: pu14 sets "underline" to yellow.
SEE ALSO: n numeric parameter
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 175
v Sets the verbose level (default 0). A value less than zero
inhibits some routine messages. A value greater then zero causes
the set command to list all string parameters, including empty
string parameters. The screen erase after data calls in host
operation is disabled. Values greater than 1 display script
commands as they are fetched from the script file.* Larger values
give more detailed tracing information. A value of 50+ causes data
read by the read command to be displayed and acted upon by the term
function (when called) as if it had arrived from the remote.
NOTE: A v parameter value greater than zero affects scripts that
generate files with the > command.
w Controls the block length used by the CompuServe B Protocol. A
longer length increases throughput, but may overload some networks,
resulting in excessive retransmissions or failed transfers. With
the new Extended Quick-B protocol, the maximum block length is 1024
data bytes. A value of 0 (the default) allows the Compuserve
computer to control the block length, up to 1024 with Extended
Quick-B.
A negative value controls the upload block length but still allows
Compuserve to control the download block length (1024 with Extended
Quick B).
Uploads to Compuserve using longer block lengths are especially
sensitive to poor flow control, especially when error correcting
modems (MNP, etc.) are used. If B protocol uploads fail or require
excessive retransmissions, correct the flow control arrangements,
disable the modem's error correction, or try a smaller upload block
size.
The data contents of successfully transferred file(s) are not
affected by this parameter.
x Sets the port number linked with the link command.
SEE ALSO: link command, y numeric parameter
y Sets the transmission speed used by the linked port.
SEE ALSO: link command, x numeric parameter
z Set the timeZone in minutes behind GMT (Greenwich Mean Time).
EXAMPLE: pz480 sets timezone 480 minutes behind GMT for PST.
SEE ALSO: d numeric parameter, ZONE environment variable
_ The _ numeric parameter controls the action taken by ZCOMM when a
fatal error (one that generates the "ZCOMM: Error..." message).
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 176
Any non zero value causes DTR to be dropped (disconnect the modem).
A value greater than 100 causes ZCOMM to exit to the operating
system. The NUKE key does not invoke this processing.
EXAMPLE: p_101
22.1 Kermit Numeric Parameters
The Super-Kermit parameters control Kermit protocol transfers. They
are set with the kermit px# command. Their current values may be
displayed with a kermit p command. These parameters rarely need
changing for most systems. They can be changed in case of difficulty
with Kermit transfers, especially with mainframe programs or obscure
microcomputer Kermit impelementations.
Certain of these parameters require character values expressed in
decimal. The ASCII code chart in Chapter 29 gives the decimal value
of all ASCII characters.
When transferring files with Kermit programs operating on IBM
mainframes with half duplex front ends, the kermit i parameter should
be set to 1, and the kermit s parameter set to the longest response
time expected, perhaps 45 seconds.
EXAMPLE: kermit pi1; kermit ps45
SEE ALSO: Kermit protocol in Chapter 11
7 If non zero, force seven bit line transmission with eighth bit
quoting Kermit transmission even if ZCOMM is otherwise using eight
bits no parity. This parameter is reset by the call command.
8 If non zero, force 8 bit transparent Kermit transmission even if
ZCOMM is otherwise using seven bit line transmission. Normally, the
Kermit file transfer commands use 7 bit line transmission and
attempt to negotiate 8th bit quoting if one of the 7 bit modes (7e,
7o, 7m, 7s) is used. This parameter is reset by the call command.
a Incoming packet-start character, default 1 (SOH).
A Outgoing packet-start character, default 1 (SOH).
b Block check type requested: 1=1 byte checksum, 2=2 byte checksum,
3=3 byte CRC-16 (default). Selecting a type 1 checksum instead of
type 3 will increase throughput by 2-4 percent at the expense of
weaker error checking. The probability of undetected errors when
using a Kermit checksum instead of CRC-16 increases dramatically
with noisy lines and long packets.
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 177
c Control prefix in incoming data, default 35 (pound sign).
C Control prefix in outgoing data, default 35 (pound sign).
d Delay in seconds before initial sending, default 0.
e Incoming end of line character, default 13 (CR).
E Outgoing end of line character, default 13 (CR).
i Use IBM line turnaround, default 0 (don't use IBM line turnaround).
The Kermit x numeric parameter sets the turnaround character. This
may be necessary when communicating with IBM mainframes with half
duplex front ends.
l Maximum outgoing packet length, default 1000, 1000 maximum. A value
greater than 94 implies Kermit long packets. The receiving program
may force shorter packets.
L Maximum incoming packet length, default 1000, 1000 maximum. A value
greater than 94 implies Kermit long packets. This sets a limit; the
sending program may use shorter packets.
p Sets the number of padding characters (default 0) to send before and
after each transmitted packet.
SEE ALSO: kermit y numeric parameter
r If non zero, remove incomplete files received with a protocol except
those received with the + option (default 0).
s Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
t Override timeout interval in seconds for incoming packets. The
default of 0 allows the other program to specifiy the timeout.
T Timeout interval for outgoing packets, default 4 seconds.
w Sliding Window size in Kermit packets, 1 minimum, 31 maximum, 15
default. Setting w to zero disables the sliding window.
x IBM turnaround character, default 17 (XON).
y Pad character to send, default 0 (NUL).
SEE ALSO: kermit p numeric parameter
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 178
22.2 X/Y/ZMODEM Numeric Parameters
These parameters control XMODEM, YMODEM, and ZMODEM protocol
transfers. They are set with the z px# command available with ZMODEM
flavors of ZCOMM. Their current values can be displayed with a z p
command. These parameters rarely need changing in normal
environments.
b If non zero, ZMODEM sends a break when it is sending a file and
receives a retransmission request. This mode of operation may be
used with high speed modems to clear unwanted characters from the
modem's buffer during error recovery. Usually, the modem must be
given a configuration command to set the proper action to take when
receiving a break signal.
B Sets the duration of the break signal in tenths of a second, default
2 (200 milliseconds).
C Sets the number of times ZMODEM will attempt to send a command (as a
result of a zcommand command) (default 11).
d Sets a Delay time in tenths of seconds that the sz command will wait
for a ZMODEM packet in response to the rzXr string it sends to the
remote before sending a ZMODEM packet. This facilitates automatic
ZMODEM uploads to VMS, which interrupts programs with the Ctrl-X
character. The call command resets this parameter to its default of
1. Higher values increase the startup time when the receiving
ZMODEM program is started before the sender.
e If non zero, escape all control characters. This allows ZMODEM
transfers to operate over data PBX and other systems that freak out
when they receive control characters.
l Normally, the ZMODEM "packet length" is the file length. Setting
this parameter non zero forces ZMODEM to close a frame and wait for
an ACK after each # bytes (default 0). This makes ZMODEM behave
like XMODEM, YMODEM, or JMODEM, which wait after each block/packet
for an acknowledgement before going on to the next block. The frame
length may be adjusted to prevent buffer overflow in data PBX
systems. The call command resets this parameter to 0.
L (Default 0) If non zero, overrides the nominal length of data
subpackets within each ZMODEM frame. A smaller value speeds error
recovery on noisy lines, a large value (maximum 1024) reduces the
overhead of CRC characters. The call command resets this parameter
to 0.
Please note that ZMODEM has no equivalent to the
XMODEM/YMODEM/JMODEM packet/block length. In the absence of errors,
ZMODEM normally sends the entire file without pause. If somebody
claims ZMODEM's 1024 byte subpacket length is slowing things down by
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 179
more than one half per cent, he doesn't understand ZMODEM and should
be ignored.
n Sets the number of NULLS (default 0) sent before each ZDATA frame.
Some buffered modems (Fastlink) have a firmware bug which loses
characters when changing the direction of transmission. This causes
data frames to fail with a reported CRC error. ZMODEM n parameter
values in the range of 100 to 150 have obviated this syndrome.
P When set to 2 (the default), purge the transmit buffer and force a
receiver response when a CR/LF sequence (indicating a PC-Pursuit
DATA LOSS message) is detected. A value of 1 does not purge the
transmit buffer. A value of 0 disables special processing of CR/LF
sequences received by the sending ZMODEM.
w If non 0, restrict the ZMODEM transmitted window to the specified
number of bytes. Setting this parameter to N requests
acknowledgements from the receiver every N/4 characters. ZCOMM then
waits for acknowledgements from the receiver whenever it has sent N
more characters than it has received acknowledgements for. This
parameter is useful with networks with defective flow control, and
with networks that store an excessive number of characters in
transit. The call command resets this parameter to 0.
W Adjusts the number of characters the ZMODEM receiver will silently
ignore when searching for the beginning of a new frame. This may be
set larger to accomodate networks with excessive in transit storage,
smaller to speed error recovery from long error bursts on direct
connections. The call command resets this parameter to the default.
Z Number of minutes (default 0) to adjust the file modification date
when using the Telink or Clink/SEAlink file transfer protocol to
transfer a file between different time zones.
The timeout parameters below may be set lower for faster X/YMODEM
error recovery when transferring files between two micros, higher to
accomodate extremely sluggish systems. Only in pathological cases is
it necessary to modify these parameters. The call command resets
these parameter to their defaults.
p Timeout in tenths of seconds for gaps within a packet (default 50).
r If non zero, remove incomplete files received with a protocol except
those received with the + option (default 0).
s Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
(C) 1988 Omen Tech Inc Chapter 22 Numeric Parameters
Version 17.32 TurboDial 2.33 Universal Line Printer Edition
ZCOMM User Manual 180
t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds
waiting for a packet or command acknowledgement (default 100).
T Transmitter timeout in tenths of seconds waiting for a packet
(default 600).
(C) 1988 Omen Tech Inc Chapter 22 String Parameters